home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / night.doc < prev    next >
Text File  |  1993-06-17  |  46KB  |  1,126 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                 Night Owl's CDROM File Retrieval System
  7.                            User's Manual
  8.  
  9.  
  10.                                                                              i
  11.                             CONTENTS
  12.  
  13. ----------------------------------------------------------------------
  14. 1.0 Introduction ..............................................  1
  15.   1.1 About the Manual ........................................  1
  16.   1.2 Night Screens ...........................................  2
  17. 2.0 Getting Started ...........................................  2
  18.   2.1 Quick Start .............................................  2
  19.   2.2 Full Installation .......................................  3
  20.   2.3 Problems Starting .......................................  4
  21. 3.0 The Main Menu Screen ......................................  4
  22.   Table 3.1  Main Menu Command Information ....................  5
  23.   3.1 DOS Shell ...............................................  5
  24.   3.2 Format Floppy ...........................................  5
  25.   3.3 Go to User Directory ....................................  6
  26.   3.4 Mouse Window for Main Menu ..............................  6
  27.     Table 3.2  Main Menu Mouse Window Command Information .....  6
  28.   3.5 On-line Help.............................................  6
  29.   3.6 Search All Categories ...................................  6
  30.   3.7 Select Category .........................................  7
  31.   3.8 Exit ....................................................  7
  32. 4.0 Category Listing ..........................................  8
  33.   Table 4.1  Category Listing Command Information .............  8
  34.   4.1 Mouse Window from Category Listing ......................  8
  35.     Table 4.2  Mouse Window from Category Listing Command
  36.                Indformation ...................................  8
  37.   4.2 Print Category Listing ..................................  9
  38.   4.3 Search Category Listing .................................  9
  39.   4.4 Tagging and Untagging Commands ..........................  9
  40.     Table 4.3 Tagging Command Information .....................  9
  41.   4.5 Exit Category Listing ................................... 10
  42. 5.0 Category Information Window ............................... 10
  43.   Table 5.1  Category Information Window Commands ............. 10
  44.   5.1 Copy Files From the Nightowl CD ROM ..................... 10
  45.   5.2 Execute a Program ....................................... 11
  46.   5.3 Extract File(s) ......................................... 11
  47.   5.4 Go to Work Area ......................................... 12
  48.   5.5 Mouse Window from Category Information Window ........... 12
  49.   Table 5.2  Category Information Window Commands ............. 12
  50.   5.6 Exit Category Information Window ........................ 12
  51.   5.7 Show Picture file ....................................... 13
  52.   5.8 View File Contents ...................................... 13
  53. 6.0 Work Area ................................................. 13
  54.   Table 6.1  Work Area Command Information .................... 14
  55.   6.1 Print File .............................................. 14
  56.   6.2 Read Text File .......................................... 14
  57.     Table 6.2  Read Text File Command Information ............. 14
  58.     6.2.1 Print File .......................................... 15
  59.     6.2.2 Search Text File .................................... 15
  60.     6.2.3 Mouse Window from Read Text File .................... 15
  61.     6.2.4 Exit Reading Text File .............................. 15
  62.   6.3 Mouse Window for Work Area .............................. 15
  63.     Table 6.3  Mouse Window from Work Area Command Information  16
  64.   6.4 Exit Work Area .......................................... 16
  65. 7.0 Shareware Information ..................................... 16
  66. 8.0 Credits and Acknowledgements .............................. 16
  67. 9.0 Glossary .................................................. 17
  68. 10.0 Error Messages ........................................... 18
  69.  
  70.  
  71.  
  72.                                                                              1
  73.  
  74.  
  75.  
  76. 1.0 Introduction
  77.  
  78.    Welcome to the Nightowl CDROM File Retrieval System.  You have just
  79.    purchased the most up-to-date single source of Shareware, Freeware and
  80.    Public Domain software available on one CDROM.  Many hours of work
  81.    have gone into making the Nightowl CDROM as  enjoyable and user friendly
  82.    as possible.
  83.  
  84.    Your ROM contains many thousands of compressed files.  Nearly 660 Mb
  85.    to be more precise.  They are all Shareware, Freeware or Public Domain.
  86.    Night Owl's Publisher takes pains to insure that no commercial software
  87.    appears on the ROM.  Please tell us if you find any commercial software
  88.    on this CD!
  89.  
  90.    The Night program and accompanying files allow you to easily search for,
  91.    find, examine, and copy the desired file(s) from this cornucopia of
  92.    software.  On-line help, mouse support and many other features are included
  93.    to help you in this process.  We beleive (and have been told by others) that it is
  94.    this is the best retrieval system in the world today!  We are interested in
  95.    your suggestions to help keep it that way.
  96.  
  97.    Contact us at:
  98.  
  99.       Night Owl's Publisher Inc.           Office 716/484-3066
  100.       1161 Falconer Stillwater Rd.         FAX    716/483-3920
  101.       Jamestown, NY 14701                  BBS    716/483-3925
  102.  
  103.  
  104. 1.1 About the Manual
  105.  
  106.    The tutorial section discusses what the Night Owl's CD ROM is and how to
  107.    get started.  The manual is written in index fashion and heavily cross
  108.    referenced to facillitate its use as a reference.
  109.  
  110.    Due to heavy cross-referencing we abbreviate the section number on
  111.    the contextual subject.  For example, we may refer to Search All
  112.    Categories (3.5).  The prior sentence tells us that Search All Categories
  113.    is covered on more detail in section 3.5.
  114.  
  115.    Commands appear as shown in the format show below.  Each command
  116.    command is labeled by section.  In our example the section number is
  117.    9.9.9.
  118.  
  119.    Example:
  120.  
  121.      9.9.9 Command Title Here
  122.  
  123.      Command Keys: Keys that trigger this command, separated by commas (,).
  124.      To Quit:  ESC
  125.  
  126.      One or more paragraphs explaining the purpose and use of the command
  127.      follow.
  128.  
  129.   Most Command Keys are case insensitive, meaning that either an upper or
  130.   lower case keystroke will activate the command.
  131.  
  132.  
  133.  
  134.                                                                              2
  135.  
  136.  
  137.  
  138.   All the tables are listings of the commands available in the current screen
  139.   context.
  140.  
  141.   When instructed to "enter" a line, press ENTER when the line is ready.
  142.  
  143.   Consult the glossary for a listing of capitalized terms that do not appear
  144.   in a section title.
  145.  
  146. 1.2 Night Screens
  147.  
  148.   A gray command bar appears at the bottom of a screen.  It lists of the
  149.   commands available for that screen.  A short command title appears in
  150.   black lettering.  Command Keys for commanda appear in red lettering next to
  151.   or within the command.
  152.  
  153.   Limited mouse support is available.  No mouse cursor appears.  Instead,
  154.   the mouse can manuver a Highlight Bar to the selection desired.
  155.  
  156.   The escape key (ESC) will back you out of most places.
  157.  
  158.  
  159. 2.0 Getting Started
  160.  
  161.    If you are just looking Night over then we suggest you use the Quick
  162.    Start (2.1).  If you intend to run Night several times then we suggest
  163.    that you install it (2.2).
  164.  
  165.    Everything needed to run Night is on the CD itself.  Although you can
  166.    take advantage of all the features of Night without installing it,
  167.    installation gives a faster response time during the Night session.
  168.  
  169.    The Quick Start differs from an Installation in two regards.  It lets
  170.    you bypass entering configuration information and run Night immediately.
  171.    When Night needs some information that is normally supplied during
  172.    installation it will ask for it the first time it is needed.  Thus,
  173.    all features are available without installing.  Secondly, it leaves
  174.    no record of the configuration you supplied once that Night session
  175.    has ended.  That means that the same information may need to be
  176.    reentered each time Night is run until Night is Installed.
  177.  
  178. 2.1 Quick Start
  179.  
  180.    To Quick Start Night follow these steps:
  181.  
  182.    1. Place the Nightowl CDROM in your CDROM drive and get to a DOS prompt.
  183.  
  184.    2. Make the CDROM drive your default drive by entering the CDROM drive
  185.       letter followed by a colon (:).
  186.  
  187.       For example, if your CDROM is drive D you would type the following:
  188.  
  189.         D:
  190.  
  191.       and press ENTER.
  192.  
  193.  
  194.  
  195.                                                                              3
  196.  
  197.  
  198.  
  199.    3. Enter NIGHT.
  200.  
  201.    5. The Quick start screen appears and offers several choices.  Select
  202.       "C" to choose a new CD ROM drive and run from that drive.
  203.  
  204.    6. Enter the drive letter as in step 2 when asked, "What drive is your CD
  205.       ROM?".
  206.  
  207.    7. Respond yes or no when asked, "Do you have a color monitor?".
  208.  
  209.    Quick start is completed.  The Main Menu screen (3.0) immediately
  210.    displays.
  211.  
  212. 2.2 Full Installation
  213.  
  214.    Installation only need be done once.  It will create the file NIGHT.CFG,
  215.    to hold the custom configuration for all subsequent runs of Night.  This
  216.    configuration may be changed by selecting the Install command from the
  217.    Main Menu.  To use the Quick Start feature after Night has been installed
  218.    just delete the file NIGHT.CFG.
  219.  
  220.    1.  Place the Nightowl CDROM in your CDROM drive and get to a DOS prompt.
  221.  
  222.    2.  Make the CDROM drive your default drive by entering the CDROM drive
  223.        letter followed by a colon (:).
  224.  
  225.        For example, if your CDROM is drive D you would type the following:
  226.  
  227.          D:
  228.  
  229.        and press ENTER.
  230.  
  231.    3.  Enter NIGHT.  The Quick Start screen displays.
  232.  
  233.    5.  The Quick Start screen appears and offers several choices.  Select
  234.        I" to choose to install Night Owl's CD ROM File Access Tools.
  235.  
  236.    6.  Respond yes or no when asked, "Do you have a color monitor?".
  237.  
  238.    7.  The Installation screen displays and prompts for configuration
  239.        information.  The text appearing in square brackets ( [] ) are the
  240.        default answers.  Be careful in responding to these questions since
  241.        an invalid answer may cause Night to quit the installation.
  242.  
  243.    8.  Enter the drive letter and path where the Night Owl files will
  244.        reside when asked for the "Location of the Default NIGHT directory."
  245.  
  246.    9.  Enter the drive letter when asked, "What drive contains the Night
  247.        Owl's CD ROM?".
  248.  
  249.  
  250.  
  251.                                                                              4
  252.  
  253.  
  254.    10. Enter the file name of the executable file that will be used to
  255.        view any picture files when asked, "What is the name of your picture
  256.        file viewer?".  The file you select must be in the DOS path or
  257.        Night won't find it.  Refer to your DOS manuals for more information
  258.        on the DOS path command.
  259.  
  260.    11. Respond with "Y", "N", or "Q" to respectively verify your answers, try
  261.        again, or quit the installation process when asked, "Is the above
  262.        information correct?".  Remember, responding "Y" with invalid answers
  263.        may cause the installation to abort.
  264.  
  265.    12. Finally, tell if the Nightowl DIR Category Listings should be copied to
  266.        your hard drive.  Copying these files gives a faster response time when
  267.        displaying a new Category Listing.   These files require approximately
  268.        1 Mb of disk space.
  269.  
  270.        "Y" continues the installation from step 13.
  271.        "N" takes no action.  The Nightowl dir text files on the ROM will be
  272.        used when needed.
  273.  
  274.        If you choose not to copy the Category Listings then go directly to
  275.        step 14.
  276.  
  277.    13. Name the directory where the Nightowl dir text files will be stored
  278.        when asked for the "New location for the DIR text files."  Files
  279.        will be copied to the specified directory.  This process takes a
  280.        little while so please be patient.
  281.  
  282.    14. The installation is complete.  Any key displays the Main Menu Screen
  283.        described in the next section.
  284.  
  285. 2.3 Problems Starting
  286.  
  287.    If some required files are not found then an error message (10.0) will
  288.    be issued for each unlocated program.  Night will search through the
  289.    DOS path first before looking on the CD ROM.  Although all the
  290.    decompression software is included on the ROM, an erroneous declaration
  291.    of the ROM drive during nstallation (2.2) will trigger this error message.
  292.  
  293.  
  294. 3.0 The Main Menu Screen
  295.  
  296.    Welcome to the Nightowl CDROM File Retrieval System.
  297.  
  298.    The Main Menu Screen should appear upon starting Night. If you get the
  299.    installation screen (2.2), or error messages (10.0) then refer to the
  300.    section noted here.  The screen includes a title bar, a listing of all
  301.    of the categories of software covered, and a Command Bar at the bottom
  302.    of the screen.
  303.  
  304.    Due to screen space, not all commands are visible on the Command Bar.
  305.    Table 3.1 has a complete command list.
  306.  
  307.  
  308.  
  309.                                                                              5
  310.  
  311.  
  312.    Upon initial entry the upper left category is hilit.  The only command
  313.    affected by the position of the Highlight Bar is the Select Category
  314.    command.  Use Manuvering Keys or mouse to move the highlit bar to the
  315.    software topic desired before Selecting.
  316.  
  317.       Table 3.1  Main Menu Command Information
  318.  
  319.                               Command    Refer to
  320.       Command Name              Keys         Section
  321.       -------------------------------------------------
  322.       DOS Shell                 D, d           3.1
  323.       Format Floppy             F, f           3.2
  324.       Go to Work Area           G, g           6.0
  325.       Go to User Directory      U, u           3.3
  326.       Help                      F1             3.4
  327.       Install                   I, i           2.2
  328.       Mouse Window              Click Right    3.5
  329.       Search All Categories     S, s           3.6
  330.       Select Category           ENTER,         3.7
  331.                                 Click Left
  332.       Exit                      ESC,           3.8
  333.                                 Mouse Window
  334.  
  335.  
  336. 3.1 DOS Shell
  337.  
  338.    Command Keys: D, d
  339.    To Quit:  type EXIT at the DOS prompt
  340.  
  341.    This command creates a DOS shell which access to all DOS commands,
  342.    subject to RAM storage requirements.  Each new shell starts from
  343.    the directory containing the Nightowl files.
  344.  
  345.  
  346.    To return from the DOS shell type "EXIT" at the DOS prompt.  Night
  347.    will return to the place that the shell was invoked from.
  348.  
  349. 3.2 Format Floppy
  350.  
  351.    Command Keys: F, f
  352.    To Quit:  ESC, Enter N when asked "Format another (Y/N)?".
  353.  
  354.    This command allows formatting either the A: or B: drive via the
  355.    DOS format command.  It is useful for preparing disks to receive
  356.    files via the Copy command (5.1).
  357.  
  358.    Respond with 'A' or 'B' when asked which drive to format.  Then
  359.    choose one the media type of that drive from the menu that then
  360.    appears.  ESC here to quit or formatting will proceed when a choice
  361.    is entered.
  362.  
  363.  
  364.                                                                              6
  365.  
  366. 3.3 Go to User Directory
  367.  
  368.    Command Keys: G, g
  369.    To Quit:  ESC
  370.  
  371.    The User Directory (3.3) is a Category Listing (4.0) of all current
  372.    search results.  The User Directory itself can be searched by invoking
  373.    a Category Search (4.3) and then exiting and reentering the User
  374.    Directory.
  375.  
  376. 3.4 Mouse Window for Main Menu
  377.  
  378.    Command Keys:  Click Right
  379.    To Quit: ESC, Click Right, Click Left on Exit
  380.  
  381.    This feature opens a window lets you perform some commands with the mouse.
  382.    Table 3.2 lists those commands.  Move the highlit text to the desired
  383.    command with Manuvering Keys or mouse and trigger it with ENTER or Click
  384.    Left.
  385.  
  386.  
  387.       Table 3.2  Main Menu Mouse Window Command Information
  388.  
  389.                          Refer to
  390.       Command Name       Section
  391.       -----------------------------------
  392.       DOS Shell              3.1
  393.       Format Floppy          3.2
  394.       Go to Work Area        6.0
  395.       Go to User Directory   3.3
  396.       Help                   3.4
  397.       Search All Categories  3.6
  398.       Exit                   3.8
  399.  
  400.  
  401. 3.5 On-line Help
  402.  
  403.    Command Keys: F1
  404.    To Quit:  ESC
  405.  
  406.    This command pops up a window with context sensitive.  If the help
  407.    information for a particular topic takes more than one window then
  408.    use the up and down arrows or mouse to make off-screen text visible.
  409.  
  410. 3.6 Search All Categories
  411.  
  412.    Command Keys: S, s
  413.    To Quit:  See below
  414.  
  415.    This command opens up a window which prompts you for the text string to
  416.    search for.  This search is not case sensitive.
  417.  
  418.  
  419.  
  420.                                                                              7
  421.  
  422.  
  423.    Enter the phrase to search for.  All Category Listings (4.0) except the
  424.    User directory (3.3) will be searched for the phrase.  A spinning
  425.    triangle in the lower right hand corner of the screen moves each time
  426.    a new file is being checked.  When the first screen is filled you may
  427.    enter further commands as shown below.
  428.  
  429.    The User directory is where search results are kept.  Choose to "A" or
  430.    "C" respectively to append this search to the current User directory or
  431.    create a fresh User directory.
  432.  
  433.    Appending allows several searches to be stored at once in the User
  434.    directory.  Note that appended searches are added such that the User
  435.    Directory remains as one big alphabetical listing.  Each new search
  436.    has its results appended to the end of the current User Directory.
  437.  
  438.    As each Category Listing is searched, a listing will be created and
  439.    displayed on the screen.  The phrase being sought and the number of
  440.    successful finds is displayed in the Command Bar.
  441.  
  442.    To continue the search when a screen has been filled type "N" for
  443.    Nonstop Search mode or ENTER to fill the next screen.  Search also
  444.    pauses when it has completed searching a Category, unless a Nonstop
  445.    search is active.
  446.  
  447.    Nonstop Search mode causes the search to continue without stopping
  448.    until the search is complete, or until ESC is pressed.
  449.  
  450.    All lines found during the Search are placed in the User directory (3.3).
  451.    When the search is complete a window appears to remind you of this fact.
  452.  
  453. 3.7 Select Category
  454.  
  455.    Command Keys: ENTER, Click Left
  456.    To Quit:  ESC, or Mouse Window (4.1)
  457.  
  458.    This command will display the Category Listing (4.0) of the currently
  459.    highlit category title.  A Category Listing contains the file name,
  460.    file size in bytes, date the file was created, and a description of
  461.    the file's contents for each file in the category.  Further commands
  462.    become active on the Category Listing screen.
  463.  
  464. 3.8 Exit
  465.  
  466.    Command Keys: ESC
  467.  
  468.    Quitting from the Main Menu quits Night and returns to DOS.
  469.  
  470.  
  471.  
  472.                                                                              8
  473.  
  474.  
  475. 4.0 Category Listing
  476.  
  477.    Command Keys: ENTER, Click Left
  478.    Quit: ESC, Mouse Window (?.?)
  479.  
  480.    A Category Listing contains the file name, file size in bytes, date the
  481.    file was created, and a description of the file's contents for each file
  482.    in the category.  Files are listed in alphabetical order by file name.
  483.  
  484.    Scroll the screen with Manuvering Keys to examine the listing.  Indicate
  485.    the file to Select with the highlight bar.  Either tag files for copying
  486.    before Selecting, or trigger an available command.
  487.  
  488.       Table 4.1  Category Listing Command Information
  489.  
  490.                                 Command      Refer to
  491.       Command Name                Keys       Section
  492.       -----------------------------------------------
  493.       Select                    ENTER,        5.0
  494.                                 Click Left
  495.       DOS Shell                 D, d          3.1
  496.       Format                                  3.2
  497.       Mouse Window              Click Right   4.1
  498.       Print Category Listing    P, p          4.2
  499.       Search Category Listing   S, s          4.3
  500.       Tag/Untag Commands                      4.4
  501.       Exit                      ESC           4.5
  502.  
  503.    Note that some of these commands do not appear in the command bar.
  504.  
  505.    The Category Information Window gives you access to further features
  506.    that aid in examination of selected files.
  507.  
  508. 4.1 Mouse Window from Category Listing
  509.  
  510.    Command Keys: Click Right
  511.    To Quit:  ESC, Click Right, Click left on ESCAPE
  512.  
  513.    This feature opens a window lets you perform some commands with the mouse.
  514.    Table 4.2 lists those commands.  Move the highlit text to the desired
  515.    command with Manuvering Keys or mouse and trigger it with ENTER or Click
  516.    Left.
  517.  
  518.  
  519.       Table 4.2  Mouse Window from Category Listing Command Information
  520.  
  521.                          Refer to
  522.       Command Name       Section
  523.       -----------------------------------
  524.       Print file list     4.2
  525.       Format floppy       3.2
  526.       Help system         3.4
  527.       Exit                5.6
  528.  
  529.  
  530.  
  531.  
  532.                                                                              9
  533.  
  534.  
  535. 4.2 Print Category Listing
  536.  
  537.    Command Keys: P, p
  538.  
  539.    Before printing the Category Listing, Night requests confirmation by
  540.    asking, "Do you want to print this directory?".  A 'Y' or Click Left
  541.    causes Night to check the printer before printing the file.  A 'N' or
  542.    Click right quits without printing.
  543.  
  544.    If the printer is not ready then Night says "Printer not ready - Any key
  545.    continues."  Any key or click then returns to the Category Listing.
  546.  
  547. 4.3 Search Category Listing
  548.  
  549.    Command Keys: S, s
  550.  
  551.    This command is the same as Search All Categories (3.6) except that only
  552.    the current Category Listing is searched.
  553.  
  554. 4.4 Tagging and Untagging Commands
  555.  
  556.    The purpose of tagging files is to mark them for inclusion in the Copy
  557.    Files command (5.1) when ready to copy all the selected files or the
  558.    highlit file.
  559.  
  560.    Upon entering a category the first file is highlit and no files are
  561.    tagged.  The highlit file appears with a gray background instead of the
  562.    usual blue.  The Highlight Bar is used to select the file that will be
  563.    acted upon by the Category Information Window (5.0) or the Copy Files
  564.    command.  Files stay tagged until untagged or until leaving the Category
  565.    Listing.
  566.  
  567.    A tagged file has different colors than a file that is both tagged and
  568.    the highlit file.  A tagged file always has either a green foreground or
  569.    background color.  The highlit file will always have a gray background.
  570.  
  571.    Files can be tagged or untagged individually or all at once.  Table
  572.    4.1 lists the tagging commands
  573.  
  574.  
  575.    Table 4.3 Tagging Command Information
  576.  
  577.                              Command      Refer to
  578.    Command Name                Keys       Section
  579.    -----------------------------------------------
  580.    Toggle highlit file tag    space
  581.    Tag whole listing            +
  582.    Untag whole listing          -
  583.  
  584.    Tagging with the space bar also advances the highlight bar to the next
  585.    file.  This accomodates advancing through the file and tagging at will
  586.    with a minimum of keystrokes.
  587.  
  588.  
  589.  
  590.                                                                              10
  591.  
  592.  
  593.  
  594. 4.5 Exit Category Listing
  595.  
  596.    Command Keys: ESC
  597.  
  598.    Exiting returns to the Main Menu (3.0).
  599.  
  600.  
  601. 5.0 Category Information Window
  602.  
  603.    This window is accessed from a Category Listing (4.0).  It displays
  604.    some category information and activates a new command bar of features.
  605.    This command bar varies depending on the extension of the highlit file
  606.    in the current Category Listing.  Table 5.1 lists the available commands
  607.    in these Command Bars.
  608.  
  609.  
  610.       Table 5.1  Category Information Window Commands
  611.  
  612.                             Command        Refer to   Available with
  613.       Command Name            Keys         Section    File Extensions
  614.       ----------------------------------------------------------------
  615.       Copy                   C, c          5.1        all extensions
  616.       DOS Shell              D, d          3.1        all extensions
  617.       Execute                ENTER,        5.2        EXE, COM, BAS, BAT
  618.                              Mouse Left
  619.       Extract File           X, x          5.3        ZIP, ARJ, LZH
  620.       Format floppy          F, f          3.2        all extensions
  621.       Goto work area         G, g          5.4        all extensions
  622.       Help                   F1            3.4        all extensions
  623.       Mouse Window           Mouse Right   5.5        all extensions
  624.       Print File             p, p          5.6
  625.       Show Picture file      S, s          5.7        GIF, PCX
  626.       View File Contents     V, v          5.8        ZIP, ARJ, LZH
  627.       Exit                   ESC           5.9        all extensions
  628.  
  629.  
  630. 5.1 Copy Files From the Nightowl CD ROM
  631.  
  632.    Command Keys: C, c
  633.    To Quit:  See below
  634.  
  635.    This command allows copying the highlit or tagged files to the path
  636.    and drive you specify.  Night verifies the target path, gives
  637.    information about storage on the target drive, and gives progress
  638.    messages during the copy process.
  639.  
  640.    If some files are tagged then enter a "T" or "H" when asked, "Copy
  641.    <T>agged or <H>ighlighted files?".
  642.  
  643.    Enter the complete target drive and path name when requested.  If
  644.    tagged files are to be copied then the number of tagged files will be
  645.    restated in this window.  To quit, enter a blank line.
  646.  
  647.    The target path will be checked before copying begins.  If the path
  648.    does not exist then an error message is issued.  Press any key to clear
  649.    the message and return to the Category Information Window.
  650.  
  651.  
  652.  
  653.                                                                              11
  654.  
  655.  
  656.    The available storage on the target drive will be checked.  If copying
  657.    to A: or B: drive then Night tells how many blank disks are needed to
  658.    hold the source files.  If the target hard drive has insufficient
  659.    storage to contain the source files then Night tells how many bytes
  660.    short the drive is.
  661.  
  662.    If the foregoing messages are satisfactory, then press "Y" when asked
  663.    to confirm the copy command.  Once final confirmation is given the
  664.    copy command cannot be aborted.
  665.  
  666.    File(s) are copied in the order they appear in the Category Listing
  667.    window.  Progress messages issued during the copying process tell
  668.    which file is being copied, how many files have been copied, and how
  669.    many total files will be copied, and if any errors are encountered.
  670.  
  671.    If a copy command fails then a warning is issued.  Night will prompt for
  672.    the insertion of the next diskette when the current one can not hold the
  673.    next file to be copied.
  674.  
  675.    When the copying is completed Night returns to the Category Information
  676.    window.
  677.  
  678. 5.2 Execute a Program
  679.  
  680.    Command Keys: ENTER, Mouse Left
  681.    To Quit:  See third paragraph below
  682.  
  683.    If the highlit file has a BAS, BAT, COM, or EXE extension then Night
  684.    asks for confirmation before offering an opportunity to enter command
  685.    line arguments for the program.
  686.  
  687.    If the program has a BAS extension then Night must find BASICA or
  688.    GWBASIC in the path before executing.  If either of those files cannot
  689.    be found then Night say so before any key returns to the Category
  690.    Information Window.
  691.  
  692.    Once the program is done a message window pops up and asks for a keystroke
  693.    before returning to the Category Information Window.  This was done to
  694.    make ending messages from the executed program visible on screen.  If
  695.    the last keystroke of the executed program normally shows up on the DOS
  696.    prompt when the program is run from DOS then no ending message will
  697.    appear.  This is because Night is fooled into thinking that the last
  698.    stroke was your confirmation to return to the Category Information Window.
  699.  
  700. 5.3 Extract File(s)
  701.  
  702.    Command Keys: X, x
  703.    To Quit: See third paragraph below
  704.  
  705.    If the highlit file has an ARJ, LZH, or ZIP extension then this feature
  706.    will decompress that file by calling the appropriate decompression
  707.    software from a DOS shell.  If Night could not find that software then
  708.    it would have already mentioned it at the start of the program.
  709.  
  710.  
  711.  
  712.                                                                              12
  713.  
  714.  
  715.  
  716.    If Night was Quick Started (2.1) and this is the first decompression then
  717.    it asks which directory the files should be decompressed in.
  718.  
  719.    As soon as the decompression is complete Night goes to the Work Area (6.0)
  720.    to await further commands.  Night returns to the Category Information
  721.    Window upon exiting the Work Area.
  722.  
  723. 5.4 Go to Work Area
  724.  
  725.    Command Keys: G, g
  726.    To Quit: ESC, Mouse Window (5.5), See also Section 6.0
  727.  
  728.    This command displays the Work Area (6.0).  It contains all the files
  729.    that have been extracted (5.3).  If the work area is empty then Night
  730.    issues a message saying so.
  731.  
  732. 5.5 Mouse Window from Category Information Window
  733.  
  734.    Command Keys: Click Right
  735.    To Quit:  ESC, Click Right, Click left on ESCAPE
  736.  
  737.    This feature opens a window lets you perform some commands with the mouse.
  738.    The available commands are shown in Table 5.2.  The up and down arrows and
  739.    ESC key also work while in this window.
  740.  
  741.  
  742.       Table 5.2  Category Information Window Commands
  743.  
  744.       Command Name        Refer to Section
  745.       -----------------------------------
  746.       Exit                5.6
  747.       Extract highlit     5.3
  748.       View highlit        5.8
  749.       Show picture file   5.7
  750.       Go to work area     5.4
  751.       Copy file(s)        5.1
  752.       Print file          5.6
  753.       DOS Shell           3.1
  754.       Format floppy       3.2
  755.       Help system         3.4
  756.  
  757. 5.6 Print File
  758.  
  759.    Command Keys: P, p
  760.    To Quit: N or Click Right
  761.  
  762.    This will allow printing the highlit file.  Night asks, "Do you want to
  763.    print <filename>?" to confirm.  Press N or Y appropriately.  If the
  764.    printer is ready then the file prints immediately.  Otherwise Night says
  765.    the printer is not ready and awaits an acknowledging keystroke.
  766.  
  767.  
  768.  
  769.                                                                              13
  770.  
  771.  
  772. 5.7 Show Picture file
  773.  
  774.    Command Keys: S, s
  775.    To Quit:  Quit your picture viewer
  776.  
  777.    If the highlit file has an GIF or PCX extension then this command allows
  778.    that picture file to viewed.  Usually the viewer selected during
  779.    installation (2.2) is used.  If this is the first time viewing a file
  780.    during a Quick Start (2.1) then Night asks for the name of the picture
  781.    viewer to use.  This viewer must be in the DOS path for Night to find it.
  782.    When done viewing the file, Night returns to the place it was called from.
  783.  
  784. 5.8 View File Contents
  785.  
  786.    Command Keys: V, v
  787.    To Quit: ESC, Click Right, or Mouse Window (5.5)
  788.  
  789.    The decompression software used by Night allows a list of the contents of
  790.    a compressed file to be viewed without extracting the file.  The informaion
  791.    displayed varies with the compressed file extension.  Each type of display
  792.    carries appropriate column headers so there should be little trouble
  793.    interpreting the information.
  794.  
  795. 5.9 Exit Category Information Window
  796.  
  797.    Command Keys: ESC
  798.  
  799.    Exiting returns to the Category Listing (4.0).
  800.  
  801.  
  802. 6.0 Work Area
  803.  
  804.    This window allows further examination of the files that were extracted
  805.    with the Extract command (5.3).  It may be entered from the Main Menu
  806.    (3.3), or the Category Information Window (5.4).  If there are no files
  807.    in the work area then Night says so before quitting the command.  To use
  808.    a file specific command just manuver the hilit bar to the desired file
  809.    and press the appropriate command key.
  810.  
  811.    Table 6.1 lists the commands available from this screen.  "File Specific"
  812.    in table 6.1 is marked if a command applies to the hilit file.  The
  813.    remaining commands are not sensitive to the hilit file.  Night allows you
  814.    the freedom to perform a command on a file even if it may not make sense;
  815.    reading an EXE file or viewing a TXT file for example.  Even when a mistake
  816.    is made the command is usually harmless to Night.  It just returns quickly
  817.    from the execution of that command.
  818.  
  819.  
  820.  
  821.                                                                              14
  822.  
  823.  
  824.       Table 6.1  Work Area Command Information
  825.  
  826.                               Command     Refer to     File
  827.       Command Name             Keys        Section   Specific
  828.       -------------------------------------------------------
  829.       DOS Shell                D, d          3.1
  830.       Execute File             ENTER,        5.2
  831.                                Mouse Left
  832.       Print File               P, p          6.1        X
  833.       Read File                R, r          6.2        X
  834.       Extract File             X, x          5.3        X
  835.       Format floppy            F, f          3.2
  836.       Help                     F1            3.4
  837.       Mouse Window             Mouse Right   6.3
  838.       Show picture file        S, s          5.7        X
  839.       Exit                     ESC           6.4
  840.  
  841. 6.1 Print File
  842.  
  843.    Command Keys: p, p
  844.    To Quit: ESC, Mouse Window (6.3)
  845.  
  846.    Before printing the highlit file Night requests confirmation by prompting,
  847.    "Do you want to print <filename>?".  A 'Y' answer causes Night to check the
  848.    printer before printing the file.  If the printer is ready then the file is
  849.    printed.  If the printer is not ready then an error message pops up to
  850.    notify you.
  851.  
  852. 6.2 Read File
  853.  
  854.    Command Keys: R, r
  855.    To Quit:  ESC
  856.  
  857.    This allows reading the contents of the highlit file.   It is meant
  858.    for ASCII text files and works best when the lines are under 80 characters
  859.    long.  Scroll the screen by use of the Manuvering Keys or select a command.
  860.  
  861.       Table 6.2  Read Text File Command Information
  862.  
  863.                               Command       Refer to
  864.       Command Name             Keys         Section
  865.       ----------------------------------------------
  866.       DOS Shell                D, d          3.1
  867.       Mouse Window             Click Left    6.2.3
  868.       Print File               P, p          6.2.1
  869.       Search Text File         S, s          6.2.2
  870.       Exit                     ESC           6.2.4
  871.  
  872.  
  873.  
  874.                                                                              15
  875.  
  876.  
  877. 6.2.1 Print File
  878.  
  879.    Command Keys: P, p
  880.    To Quit: N
  881.  
  882.    The message "Do you want to print <filename> ?" asks for confirmation
  883.    before printing.  Enter N to abort printing or Y to confirm it.
  884.  
  885.    If the printer is not ready then a warning message appears.
  886.    Any key removes this message and returns to the Work Area (6.0).
  887.  
  888.    Beware printing executable or other files that do not contain text.
  889.    If unsure about the contents of a file then read it first with Read
  890.    File (6.2).  If there are garbage characters in it then printing
  891.    the file will be of little use.
  892.  
  893. 6.2.2 Search Text File
  894.  
  895.    Command Keys: S, s
  896.    To Quit:  Automatic
  897.  
  898.    A window appears and asks, "Text string to search for?".  Press ESC to
  899.    abort the search or enter the search phrase.  Night starts searching from
  900.    the second line on the screen and brings the next occurance of the search
  901.    phrase to the top of the screen and highlights all occurances.  If no
  902.    matched are found then Night advances to the bottom of the file.
  903.  
  904.    The last phrase entered becomes the default phrase to allow searching
  905.    again by just ENTER.  To remove the highlit phrases, start a search and
  906.    ESC from it.
  907.  
  908. 6.2.3 Mouse Window from Read Text File
  909.  
  910.    Command Keys: Click Left
  911.  
  912.    Table 6.2 Contains all the commands available from this Mouse Window.
  913.    Use Manvuering Keys or mouse to highlight your choice.  Then Click Left
  914.    or ENTER to trigger that choice.
  915.  
  916. 6.2.4 Exit Reading Text File
  917.  
  918.    Command Keys: ESC, Mouse Window (6.3)
  919.  
  920.    Exiting the work area return to the place where it was called from.
  921.  
  922. 6.3 Mouse Window for Work Area
  923.  
  924.    Command Keys: Click Right
  925.    To Quit: ESC, Click Right, Click Left on Exit
  926.  
  927.    This feature opens a window lets you perform some commands with the mouse.
  928.    Table 6.3 lists those commands.  Move the highlit text to the desired
  929.    command with Manuvering Keys or mouse and trigger it with ENTER or Click
  930.    Left.
  931.  
  932.  
  933.  
  934.  
  935.                                                                              16
  936.  
  937.  
  938.       Table 6.3  Mouse Window from Work Area Command Information
  939.  
  940.                          Refer to
  941.       Command Name       Section
  942.       ---------------------------
  943.       DOS Shell           3.1
  944.       Extract file        5.3
  945.       Format floppy       3.2
  946.       Help system         3.4
  947.       Print file          6.1
  948.       Read file           6.2
  949.       Show picture file   5.7
  950.       Exit                6.4
  951.  
  952.  
  953. 6.4 Exit Work Area
  954.  
  955.    Command Keys: ESC, see below
  956.  
  957.    Night asks if the files in the work area should be deleted before leaving.
  958.    Press Y or N appropriately.  A Click Left is the same as 'Y.'  A Click
  959.    Right is the same as 'N.'
  960.  
  961.  
  962. 7.0 Shareware Information
  963.  
  964.    Shareware programs are not FREE programs or public domain programs.  They
  965.    are copyrighted programs that the authors have released to the public for
  966.    the purpose of examination and test use only.  You should register the
  967.    program with the author if you like it and want to continue to use it.
  968.  
  969.    Night Owl's Publisher Inc. takes pains to insure that no commercial software
  970.    appears on the CD.  If you find any such software on the CD then please
  971.    notify us as soon as possible.  Our address is listed in the Introduction
  972.    (1.0).
  973.  
  974.  
  975. 8.0 Credits and Acknowledgements
  976.  
  977.                 (c) Copyright 1993 All Rights Reserved
  978.  
  979.    ASP            Trademark of (c) Association Shareware Professioals
  980.    PKUnzip.exe    Trademark of (c) PKware Inc.
  981.    VPIC           Trademark of (c) Bob Montgomery
  982.    WordPerfect    Trademark of (c) Word Perfect Corporation
  983.    Pascal         Trademark of (c) Word Perfect Corporation
  984.    List           Trademark of (c) Vernon D. Buerg
  985.    Lotus          Trademark of (c) Borland Inc.
  986.    Windows        Trademark of (c) Microsoft Corporation
  987.    Gap            Trademark of (c) Gap Development Company
  988.    Night          Trademark of (c) Night Owls
  989.  
  990.  
  991.  
  992.                                                                              17
  993.  
  994.  
  995.    We also want to take the time to acknowledge the scores of other
  996.    trademarks and copyrights found throughout the zipped files on the
  997.    Nightowl CDROM.
  998.  
  999.    Again, support shareware authors by registering their programs.
  1000.  
  1001.    Special thanks to:
  1002.  
  1003.    Phil Katz
  1004.       For allowing us to use his program as a part of the Nightowl CDROM.
  1005.       PKZip is a very useful program.
  1006.  
  1007.  
  1008. 9.0 Glossary:
  1009.  
  1010.   Category Listing Window - See section 5.0
  1011.   Command Bar - A command bar appears at the bottom of the screen.  It shows
  1012.      a list of keystroke commands that are active for the current
  1013.      screen.
  1014.   Command Key - A key which, when pressed, will trigger a specific feature
  1015.      of Night.
  1016.   Compressed Files - Files whose contents have been compressed to minimize
  1017.      storage requirements.  Night handles compressed files with ARJ, LZH, or
  1018.      ZIP extensions.
  1019.   Configuration File - Holds custom settings for an installed version of
  1020.      Night.
  1021.   ENTER - The "Enter" or "Return" key.
  1022.   ESC  - The Escape key.  Usually labeled as "Esc".
  1023.   Work Area - See section (6.0).
  1024.   file specific command - A command that will process only the selected file
  1025.      or files.  Only the Category Listing allows several files to be included
  1026.      in a file specific command.
  1027.   Highlight Bar - Sometimes refered to as the being "hilit."  Some commands
  1028.      act upon the highlit file.
  1029.   Main Menu - You know... the Main Menu.  Geez everybody knows that.
  1030.   Manuvering Keys - Keys usually used when moving a reference point on the
  1031.      screen.  The keys that comprise all manuvering keys are PgUp, PgDn,
  1032.      Up and Down arrows (), Home, End.
  1033.   Night - The program name for the Nightowl CDROM File Retrieval System
  1034.      user interface.
  1035.   Nightowl CDROM File Retrieval System - The CDROM itself.
  1036.   Picture file - A file that holds a graphic mode picture.  GIF or PCX
  1037.      extensions currently recognized as picture files.
  1038.   Quick Start - See section 2.1.  Allows operation of Night from ROM without
  1039.      the full installation process.  Night will ask for needed information as
  1040.      required by the features selected.  This information is recorded and
  1041.      used for the remainder of the program session.
  1042.   User Directory - See section 3.3.
  1043.   Work Area - See section 6.0.
  1044.  
  1045.  
  1046.  
  1047.                                                                              18
  1048.  
  1049.  
  1050. 10.0 Error Messages
  1051.  
  1052.   Some error messages mention varying items.  A general decription of
  1053.   those items are enclosed in angle brackets (<>).  Those errors that
  1054.   may be correctabe will have remedies listed.
  1055.  
  1056.   Cannot find file info - Night requries special information about some
  1057.      of the files it opens.  This special could not be discerned.
  1058.   Cannot find home directory - Night could not save the name of the
  1059.      current directory before switching to another directory.
  1060.   Cannot open <Category Title> in read_dir_file - The Night routine
  1061.      read_dir_file() could not find the requested file.  Check
  1062.      configuration by the Install command (2.2).
  1063.   Cannot open <filename> - Could not open the requested file.
  1064.   Cannot open file for printing - Could not open the requested file.
  1065.   Cannot open Main Categories File  - Could not find the Main Menu file.
  1066.      Try deleting NIGHT.CFG and reinstalling Night.
  1067.   Cannot write to <path>  - Could not write the new configuration file.
  1068.      See if the path exists from DOS.
  1069.   Chmod error copying <filename> - File attributes prevented copying.
  1070.      Alter the attributes with the DOS "attrib" command.
  1071.   Drive <drive> is to full. - The destination drive for a copy command did
  1072.      not have enough remaining storage to copy the last file requested.
  1073.      Delete some files on the target drive.  Smaller files mayu still fit.
  1074.   Error copying <filename>  - DOS copy command failed for unknown reason.
  1075.      Try the copy command from DOS.
  1076.   Error restoring text in <routine name> - Could not restore an the screen
  1077.      under the pop up window.  Any key continues.  This may result in
  1078.      garbage on the screen.  Exit and reenter the screen if garbage appears.
  1079.   Error saving text in <routine name> - Could not save a portion of the
  1080.      screen for later redisplay.  Press any key to contine.  This will
  1081.      probably result in garbage on the screen when returning from the
  1082.      pop up window.  Exit and reenter the screen to remove garbage.
  1083.   Error writing to <User Directory> - Could not open the User directory
  1084.      (6.0).  Try searching with the Create option (3.5, paragraph 3).  You
  1085.      may wish to save the existing User Directory file named DIR.USR before
  1086.      doing this.
  1087.   Failed dirlines [<line number>] malloc in malloc_dirline - The Night
  1088.      routine malloc_dirline() ran out of memory to hold a Category
  1089.      Listing in the dirlines array.  Remove TSRs or other programs that
  1090.      take up RAM.
  1091.   Failed malloc for <variable> global_malloc -  Could not allot memory
  1092.      for a needed variable.  Remove TSRs or other programs that take up
  1093.      RAM.
  1094.   Failed malloc in <routine name>  - Ran out of memory when requesting
  1095.      needed space in the named routine.  Remove TSRs or other programs
  1096.      that take up RAM.
  1097.   Failed to copy <filename> - DOS copy command failed for unknown reason.
  1098.      Try the copy command from DOS.
  1099.   No PKUNZIP.EXE in path.  Need it for *.ZIP decompression. - Could not
  1100.      find pkunzip.exe in the DOS path.  Change your path or move pkunzip.exe
  1101.      into a directory that is in the path.
  1102.   No ARJ.EXE in path.  Need it for *.ARJ decompression.  - Could not
  1103.      find pkunzip.exe in the DOS path.  Change your path or move pkunzip.exe
  1104.      into a directory that is in the path.
  1105.  
  1106.  
  1107.                                                                              19
  1108.  
  1109.  
  1110.   No LHA.EXE in path.  Need it for *.LZH decompression.  - Could not
  1111.      find pkunzip.exe in the DOS path.  Change your path or move pkunzip.exe
  1112.      into a directory that is in the path.
  1113.   Not enough free space. - The destination drive for a copy command does not
  1114.      have enough remaining storage to copy all of the files requested.  Some
  1115.      files may be able to fit.  Delete some files on the target drive.
  1116.   <Path> does not exist. - Could not find the specified path.  Check spelling.
  1117.   <Path> is an invalid path name - The entered path contains illegal
  1118.      characters or could not be found.  Check spelling.
  1119.   Printer not ready - Check to see if the printer is connected and on line.
  1120.   Search phrase to broad. - There were to many matches for the search phrase
  1121.      entered.  Up to 500 matches are allowed.  Make the search phrase more
  1122.      explicit.
  1123.   Target drive to full. - The destination drive for a copy command did not
  1124.      have enough remaining storage to copy the last file requested.  Delete
  1125.      some files on the target drive.
  1126.